home *** CD-ROM | disk | FTP | other *** search
/ Mission 3 / Mission 3.zip / Mission 3.iso / divers / schon_me / shme_sys / smm_conf / smm_conf.stg < prev    next >
Text File  |  1997-08-13  |  5KB  |  173 lines
  1. ##ACE-STGPAR 4 0022 
  2. @database "SMM-Konfig 0.7"
  3. @author "R.G.Faika, GORDON Soft"
  4. @$VER: SMM_CONF.HYP (@:"__DATE__")
  5. @subject "Dokumentation"
  6. @options "+z-s-j-d12"
  7.  
  8. @node main "SMM-Konfig 0.7"
  9. @symbol r SHME
  10. @{B}@{"SMM-Konfig" ignore} @{0}
  11. @line 1 75 0 0 7
  12.  
  13. SMM_CONF.PRG
  14. Programm zur Konfiguration von SMM-Modulen
  15. für den Bildschirmschoner Schon-Me.
  16. Status: Freeware
  17. Version: 0.7
  18. Autor: Richard Gordon Faika
  19. 1997 Gordon Soft
  20.  
  21.  
  22.  
  23. Anleitung zu SMM_CONF.PRG
  24.  
  25.  
  26. SMM-Konfig
  27. Konfigurieren eines Modules
  28. Hinweis für Programmierer von Modulen
  29. Kontakt
  30.  
  31. @endnode
  32.  
  33. @node "SMM-Konfig"
  34. @{B}@{"SMM-Konfig" ignore} @{0}
  35. @line 1 75 0 0 7
  36.  
  37. SMM-Konfig ist ein kleines Programm zu einfachen Konfiguration von 
  38. SMM-Modulen.
  39. Es können nur solche SMM-Module konfiguriert werden, die dafür vom
  40. Programmierer entsprechend angepasst wurden.
  41.  
  42.  
  43. @endnode
  44. @node "Konfigurieren eines Modules"
  45. @{B}@{"Konfigurieren eines Modules" ignore} @{0}
  46. @line 1 75 0 0 7
  47.  
  48. Die Konfiguration ist recht einfach:
  49.  
  50. 1. Auswählen des Modules durch klicken in das Feld von 'Module'
  51.    Ist die ausgewählte Datei ein SMM-Modul und konfigurierbar,
  52.    wird es geladen und die Konfigurationswerte ausgelesen.
  53.  
  54. 2. Statt den Texten 'Parameter 1' bis 'Parameter 6' erscheinen
  55.    nun die Texte zur Information, was man pro Parameterfeld jeweils 
  56.    einstellen kann. Nicht belegte Parameter werden erkannt und im
  57.    Infotext zum Parameterfeld steht dann 'nicht benutzt'.
  58.    
  59. 3. Setzen eigener Einstellungen
  60.  
  61. 4. Speichern mit dem Button 'Sichern'. -Das Modul wird mit den neuen 
  62.    Parametern unter gleichem Namen abgespeichert.
  63.    
  64. 5. Verlassen des Konfigurationsprogrammes durch schließen des Haupt-
  65.    Dialoges oder durch betätigung von 'Abbruch'.
  66.    
  67.    
  68. Sonstiges:
  69.  
  70. 'Info' öffnet den Informationsdialog zu SMM-Konfig.
  71. 'Hilfe' ruft die Onlinehilfe auf, sofern ST-Guide installiert ist.
  72.  
  73. Das wars.
  74. Wer Informationen zum Einbauen einer Konfigurationsmöglichkeit in
  75. eigene Module sucht, lese sich bitte den Text 'SMM_NEW.TXT' bzw.
  76. im Hypertext den Part 'Hinweis für Programmierer von Modulen' durch.
  77.  
  78. viel Vergnügen,
  79. Richard Gordon Faika
  80.  
  81. @endnode
  82. @node "Hinweis für Programmierer von Modulen"
  83. @{B}@{"Hinweis für Programmierer von Modulen" ignore} @{0}
  84. @line 1 75 0 0 7
  85.  
  86.  
  87. Eigene Module konfigurierbar programmieren.
  88. ..auch ganz einfach:
  89.  
  90. Die normalen Richtlinien zur Programmierung eines Modules gelten 
  91. weiterhin. Module ohne Konfigurierbarkeit können auch weiterhin
  92. mit Schon-me genutzt werden.
  93.  
  94. Möchte man nun sein eigenes Modul einstellbar gestalten muß man folgendes
  95. in sein Modul einbauen. Am besten hinter die erste Abbruchabfrage
  96. im Modul, ich erinnere: 'Am Anfang des Modules die Adresse $6C abfragen
  97. ob sie Null ist, wenn nicht, beenden'.
  98.  
  99. Folgendes Muß man einbauen:
  100.  
  101. 1. einen Festen Speicherbereich innerhalb des Programmes, also im DATA-
  102.    Segment eines Programmes (für GFABASIC beispielsweise ein Inline)
  103.    Größe: 256 Byte
  104.    
  105. Dieser Speicherbereich ist folgendermaßen aufgebaut:
  106.  
  107. Es gibt 6 Parametermöglichkeiten, die von SMM-Konfig beachtet werden.
  108. Alle sechs Parameterblöcke stehen Nacheinander im Speicherbereich.
  109.  
  110.  Bedeutung            | Offset | Wert          | Länge (Byte)
  111.  ---------------------|--------|---------------|----------------------
  112.  Identifikation       | 0      | 'SHME'        | 4 
  113.                       |        |               |
  114.  Parameter 1          | 4      | eigener       | 4 
  115.  Parametertext-Länge  | 8      | Textlänge     | 1
  116.  Parametertext 1      | 9      | Text          | 0=unbenutzt, max. 20
  117.  Parameter 2          | 10     | eigener       | 4 
  118.  Parametertext-Länge  | 14     | Textlänge     | 1
  119.  Parametertext 2      | 15     | Text          | 0=unbenutzt, max.20
  120.  
  121.  usw. bis Parameter 6
  122.  
  123.  Der Rest des Speicherbereiches ist dann mit Nullen aufzufüllen.
  124.  (für spätere Erweiterungen nützlich)
  125.  
  126.  
  127.  Hinweis:
  128.  
  129.  Die Parameter werden von SMM-Konfig nur als *Zahl*(Long) gelesen und
  130.  geschrieben.
  131.  
  132.  
  133.  Was macht dann SMM-Konfig?
  134.  
  135.  SMM-Konfig sucht nach der Identifikation 'SHME', liest die Parameter
  136.  und den Infotext aus und setzt beides dann in die Felder Parameter 1-6
  137.  ein.
  138.  Beim Speichern schreibt SMM-Konfig dann nur die neuen Parameter-Werte.
  139.  
  140.  
  141.  Warum kompliziert, wenns auch einfach geht.
  142.  Richard Gordon
  143.              
  144. @endnode
  145. @node "Kontakt"
  146. @{B}@{"Kontakt" ignore} @{0}
  147. @line 1 75 0 0 7
  148.  
  149. Für Fragen stehe ich jederzeit gerne zur Verfügung.
  150. Richard Gordon Faika
  151. Email:
  152. Richard-Gordon Faika @ B
  153. richard-gordon.faika@b.maus.de
  154. Post:
  155. Richard Sorge Str.24
  156. 10249 Berlin
  157. Tel:
  158. (030)422 39 48 
  159. Bankverbindung:
  160. Name    : Richard Gordon Faika
  161. Konto   : 150 159 69
  162. BLZ     : 100 900 00
  163. Institut: Berliner Volksbank
  164.  
  165.  
  166. Berlin den 08.08.1997
  167. GORDON Soft
  168.  
  169.  
  170. @endnode
  171.  
  172.  
  173.